Queries the state of a mounted image handle.

BOOL
WINAPI
WIMGetMountedImageInfoFromHandle(
   HANDLE hImage,
   MOUNTED_IMAGE_INFO_LEVELS fInfoLevelId,
	PVOID  pMountInfo,
	DWORD  cbMountInfoLength,
	PDWORD pcbReturnLength
	);

Parameters

hImage

[in] A handle to an image that has been mounted.

fInfoLevelId

[in] A class of attribute information to retrieve.

This parameter can be the value from the MOUNTED_IMAGE_INFO_LEVEL enumeration.

Value Description

MountedImageInfoLevel0

The pMountedInfo parameter is an array of WIM_MOUNT_INFO_LEVEL0 structures.

MountedImageInfoLevel1

The pMountedInfo parameter is an array of WIM_MOUNT_INFO_LEVEL1 structures.

pMountInfo

[out opt] Pointer to a variable that receives mounted image structures. The size of the information written varies depending on the type of structured defined by the fInfoLevelId.

cbMountInfoLength

[in] The size of the buffer pointed to by the pMountInfo parameter, in bytes.

pcbReturnLength

[out] A pointer to a variable which contains the result of a function call that returns the size of the requested information. If the function was successful, this is the size of the information written to the buffer pointed to by the pMountInfo parameter; if the buffer was too small, then this is the minimum size of buffer needed to receive the information successfully.

Return Value

If the function succeeds, then the return value is nonzero. If the function fails, then the return value is zero. To obtain extended error information, call the GetLastError function. If the buffer specified by the cbMountInfoLength parameter is not large enough to hold the data, the function sets the value of LastError to ERROR_INSUFFICIENT_BUFFER and stores the required buffer size in the variable pointed to by pcbReturnLength.

See Also