Função GetNtmsMediaPoolNameA (ntmsapi.h)

  • Artigo

[O Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]

A função GetNtmsMediaPoolName recupera a hierarquia de nome completo do pool de mídia especificado.

Sintaxe

DWORD GetNtmsMediaPoolNameA(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpPoolId,
  [out]     LPSTR       lpNameBuf,
  [in, out] LPDWORD     lpdwBufSize
);

Parâmetros

[in] hSession

Manipule para a sessão retornada pela função OpenNtmsSession .

[in] lpPoolId

Identificador exclusivo do pool de mídia cujo nome deve ser recuperado.

[out] lpNameBuf

Ponteiro para um buffer que recebe o nome do pool de mídia.

[in, out] lpdwBufSize

Tamanho do buffer lpBufName , na entrada. Na saída, o número de caracteres na hierarquia de nome completo.

Retornar valor

Essa função retorna um dos valores a seguir.

Valor Significado
ERROR_INSUFFICIENT_BUFFER
 O tamanho do buffer não é grande o suficiente. O tamanho correto é retornado em lpdwBufSize.
ERROR_INVALID_HANDLE
 O valor especificado no parâmetro hSession é NULL ou não é válido.
ERROR_INVALID_MEDIA_POOL
 A ID do pool de mídia está ausente ou não é válida.
ERROR_INVALID_PARAMETER
 O parâmetro está ausente ou não é válido.
ERROR_NOT_ENOUGH_MEMORY
 Falha na alocação de memória.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

Observação

O cabeçalho ntmsapi.h define GetNtmsMediaPoolName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntmsapi.h
Biblioteca Ntmsapi.lib
DLL Ntmsapi.dll

Confira também

CreateNtmsMediaPool

Funções dos Serviços de Mídia