MprConfigGetFriendlyName-Funktion (mprapi.h)

Die MprConfigGetFriendlyName-Funktion gibt den Anzeigenamen für eine Schnittstelle zurück, die dem angegebenen GUID-Namen entspricht.

Syntax

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

[in] hMprConfig

Handle für die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] pszGuidName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den GUID-Namen für die Schnittstelle angibt.

[out] pszBuffer

Zeiger auf einen Puffer, der den Anzeigenamen für die Schnittstelle empfängt.

[in] dwBufferSize

Gibt die Größe des Puffers in Bytes an, auf den pszBuffer verweist.

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_BUFFER_OVERFLOW	Der Puffer, auf den pszBuffer verweist, ist nicht groß genug, um den zurückgegebenen GUID-Namen zu enthalten.
ERROR_INVALID_PARAMETER	Einer der folgenden Parameter hMprConfig, pszGuidName oder pszBuffer ist NULL.
ERROR_NOT_FOUND	Es wurde kein GUID-Name gefunden, der dem angegebenen Anzeigenamen entspricht.

Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll