MprConfigGetGuidName-Funktion (mprapi.h)

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

Syntax

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

[in] hMprConfig

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

[in] pszFriendlyName

Zeiger auf eine Unicode-Zeichenfolge, die den Anzeigenamen für die Schnittstelle angibt.

[out] pszBuffer

Zeiger auf einen Puffer, der den GUID-Namen 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	Mindestens einer der Parameter hMprConfig, pszFriendlyName oder pszBuffer ist NULL.
ERROR_NOT_FOUND	Es wurde kein GUID-Name gefunden, der dem angegebenen Anzeigenamen entspricht.

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