Función GetNtmsMediaPoolNameA (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 completo del grupo de medios especificado.

Sintaxis

DWORD GetNtmsMediaPoolNameA(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpPoolId,
  [out]     LPSTR       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 completo.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor	Significado
ERROR_INSUFFICIENT_BUFFER	El tamaño del búfer no es lo suficientemente grande. El tamaño correcto se devuelve en lpdwBufSize.
ERROR_INVALID_HANDLE	El valor especificado en el parámetro hSession es NULL o no es válido.
ERROR_INVALID_MEDIA_POOL	Falta el identificador del grupo de medios o no es válido.
ERROR_INVALID_PARAMETER	Falta el parámetro o no es válido.
ERROR_NOT_ENOUGH_MEMORY	Error en la asignación de memoria.
ERROR_SUCCESS	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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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

Consulte también

CreateNtmsMediaPool

Funciones de Media Services