Função MprConfigGetFriendlyName (mprapi.h)

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

Sintaxe

DWORD MprConfigGetFriendlyName(
  [in]  HANDLE hMprConfig,
  [in]  PWSTR  pszGuidName,
  [out] PWCHAR pszBuffer,
  [in]  DWORD  dwBufferSize
);

[in] hMprConfig

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

[in] pszGuidName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome GUID da interface.

[out] pszBuffer

Ponteiro para um buffer que recebe o nome amigável da interface.

[in] dwBufferSize

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

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	Um dos parâmetros a seguir hMprConfig, pszGuidName ou pszBuffer é NULL.
ERROR_NOT_FOUND	Nenhum nome GUID foi encontrado que corresponda ao nome amigável especificado.

Para obter mais informações, consulte Avoiding Buffer Overruns (Evitando estouros de buffer).

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