Función GetNtmsMediaPoolNameW (ntmsapi.h)
[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]
La función GetNtmsMediaPoolName recupera la jerarquía de nombres completa del grupo de medios especificado.
Sintaxis
DWORD GetNtmsMediaPoolNameW(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpPoolId,
[out] LPWSTR lpNameBuf,
[in, out] LPDWORD lpdwBufSize
);
Parámetros
[in] hSession
Identificador de la sesión devuelta por la función OpenNtmsSession .
[in] lpPoolId
Identificador único del grupo de medios cuyo nombre se va a recuperar.
[out] lpNameBuf
Puntero a un búfer que recibe el nombre del grupo de medios.
[in, out] lpdwBufSize
Tamaño del búfer lpBufName , en la entrada. En la salida, el número de caracteres de la jerarquía de nombres completa.
Valor devuelto
Esta función devuelve uno de los valores siguientes.
Valor | Significado |
---|---|
|
El tamaño del búfer no es lo suficientemente grande. El tamaño correcto se devuelve en lpdwBufSize. |
|
El valor especificado en el parámetro hSession es NULL o no es válido. |
|
Falta el identificador del grupo de medios o no es válido. |
|
Falta el parámetro o no es válido. |
|
Error en la asignación de memoria. |
|
La función se realizó correctamente. |
Comentarios
Nota
El encabezado ntmsapi.h define GetNtmsMediaPoolName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | ntmsapi.h |
Library | Ntmsapi.lib |
Archivo DLL | Ntmsapi.dll |