Compartilhar via


Função MprConfigGetGuidName (mprapi.h)

A função MprConfigGetGuidName retorna o nome GUID de uma interface que corresponde ao nome amigável especificado.

Sintaxe

DWORD MprConfigGetGuidName(
  [in]  HANDLE hMprConfig,
  [in]  PWSTR  pszFriendlyName,
  [out] PWCHAR pszBuffer,
  [in]  DWORD  dwBufferSize
);

Parâmetros

[in] hMprConfig

Manipule para a configuração do roteador. Obtenha esse identificador chamando MprConfigServerConnect.

[in] pszFriendlyName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome amigável para a interface.

[out] pszBuffer

Ponteiro para um buffer que recebe o nome GUID da interface.

[in] dwBufferSize

Especifica o tamanho, em bytes, do buffer apontado por pszBuffer.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor Significado
ERROR_BUFFER_OVERFLOW
O buffer apontado por pszBuffer não é grande o suficiente para manter o nome GUID retornado.
ERROR_INVALID_PARAMETER
Pelo menos um dos parâmetros hMprConfig, pszFriendlyName ou pszBuffer é NULL.
ERROR_NOT_FOUND
Nenhum nome GUID foi encontrado que corresponda ao nome amigável especificado.
 
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

MprConfigGetFriendlyName

MprConfigServerConnect

Funções de configuração do roteador

Referência de gerenciamento de roteador