Compartir a través de

Función GetNtmsMediaPoolNameW (ntmsapi.h)

  • Artículo

[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 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 de 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 siguientes valores.

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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de ntmsapi.h
biblioteca de Ntmsapi.lib
DLL de Ntmsapi.dll

Consulte también

CreateNtmsMediaPool

funciones de Media Services de