Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Recupera el descriptor de dispositivo para el dispositivo.
Sintaxis
HRESULT GetDeviceDescriptor(
[out] BYTE **data,
[out] ULONG_IMAPI2_DEVICE_DESCRIPTOR *byteSize
);
Parámetros
[out] data
Búfer de datos que contiene el descriptor del dispositivo de almacenamiento. Para obtener más información sobre el contenido del búfer de datos, consulte la estructura de STORAGE_DEVICE_DESCRIPTOR en DDK.
Cuando haya terminado, llame a la función CoTaskMemFree para liberar la memoria.
[out] byteSize
Tamaño, en bytes, del búfer de datos.
Valor devuelto
S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:
| Código devuelto | Descripción |
|---|---|
|
El puntero no es válido.
Valor: 0x80004003 |
|
Error no especificado.
Valor: 0x80004005 |
|
No se pudo asignar la memoria necesaria.
Valor: 0x8007000E |
Requisitos
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi2.h |