User guide

Guardian Procedures
HP NonStop Storage Management Foundation User's Guide—523562-007
8-23
SMS_GETVIRTUALDISKHDR_
Syntax for C Programmers
SMS_GETVIRTUALDISKHDR_
The SMS_GETVIRTUALDISKHDR_ procedure retrieves configuration information for a
particular virtual disk process.
error returned value
INT
indicates the outcome of the operation. If an error occurs, a file system error
number is returned, the output length of the supplied buffer parameter is set to
zero, and the contents of the buffer are undefined. If no error occurs, FEOK (zero)
is returned.
virt-disk-name:virt-disk-name-length input:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer containing the virtual disk name.
virt-disk-config-buffer:
virt-disk-config-buffer-max-length output:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer to which information about the virtual disk
should be returned. If the buffer is not large enough to hold the information, an
error is returned; this error is retryable. The virt-disk-config-buffer should
be at least 116 bytes long.
The information returned might not reflect the actual current status, because SMF
might have processed status change notifications from subsystems on which it
depends after constructing the reply.
#include <cextdecs(SMS_GETVIRTDISKSTART_)>
short SMS_GETVIRTDISKSTART_
( [char *system-name
,short system-name-length]
,[char *pool-name
,short pool-name-length]
);
error := SMS_GETVIRTUALDISKHDR_
(virt-disk-name:virt-disk-name-length ! i:i
,virt-disk-config-buffer:
virt-disk-config-buffer-max-length ! o:i
,virt-disk-config-buffer-out-length ! o
)CALLABLE, EXTENSIBLE;