Funzione MprConfigGetGuidName (mprapi.h)

La funzione MprConfigGetGuidName restituisce il nome GUID per un'interfaccia corrispondente al nome descrittivo specificato.

Sintassi

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

[in] hMprConfig

Gestire la configurazione del router. Ottenere questo handle chiamando MprConfigServerConnect.

[in] pszFriendlyName

Puntatore a una stringa Unicode che specifica il nome descrittivo per l'interfaccia.

[out] pszBuffer

Puntatore a un buffer che riceve il nome GUID per l'interfaccia.

[in] dwBufferSize

Specifica le dimensioni, in byte, del buffer a cui fa riferimento pszBuffer.

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_BUFFER_OVERFLOW	Il buffer a cui fa riferimento pszBuffer non è abbastanza grande per contenere il nome GUID restituito.
ERROR_INVALID_PARAMETER	Almeno uno dei parametri hMprConfig, pszFriendlyName o pszBuffer è NULL.
ERROR_NOT_FOUND	Non è stato trovato alcun nome GUID che corrisponde al nome descrittivo specificato.

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll