Get_Partition_Handle

#include <lvm_intr.h>

ADDRESS _System Get_Partition_Handle(

    CARDINAL32   Serial_Number,   /* (I) Partition serial number being queried */
    CARDINAL32 * Error_Code       /* (O) Address where the error code will be stored */

);

Parameters

Serial_Number

This is the serial number to look for. If a partition with a matching serial number is found, its handle will be returned.

Error_Code

The address of a CARDINAL32 in which to store an error code should an error occur.

Returns

If a partition with a matching serial number is found, then the function return value will be the handle of the partition found. If no matching partition is found, then the function return value will be NULL.

Errors

If no errors occur, the value pointed to by Error_Code will be 0 (LVM_ENGINE_NO_ERROR). If an error occurs, then the value pointed to by Error_Code will be greater than 0.

Side Effects

None.

Notes

None.

16-Bit Equivalent:

void _Far16 _Pascal _loadds GET_PARTITION_HANDLE16(
        CARDINAL32          Serial_Number,
        CARDINAL32 * _Seg16 Handle,
        CARDINAL32 * _Seg16 Error_Code
);