NPGetUniversalName-Funktion (npapi.h)

Artikel
08/25/2023

Ruft den universellen Namen einer Netzwerkressource ab. Die NPGetUniversalName-Funktion kann diesen universellen Namen im UNC-Format oder im älteren Remotenamenformat abrufen.

Syntax

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parameter

[in] lpLocalPath

Zeiger auf den lokalen Pfad eines Objekts in einer Netzwerkressource. Dies ist ein laufwerksbasierter Pfad.

[in] dwInfoLevel

Der Detailgrad der Informationen, für die der Anrufer interessiert ist. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
UNIVERSAL_NAME_INFO_LEVEL	Ruft die UNC-Form des Namens ab, z. B. "file:\\server\share" Wenn dieser Wert festgelegt ist, werden die in lpBuffer zurückgegebenen Daten als UNIVERSAL_NAME_INFO-Struktur gespeichert.
REMOTE_NAME_INFO_LEVEL	Ruft die Remoteform des Namens ab, z. B.: "\\server\share" Wenn dieser Wert festgelegt ist, werden die in lpBuffer zurückgegebenen Daten als REMOTE_NAME_INFO-Struktur gespeichert.

[out] lpBuffer

Zeiger auf einen Puffer, um die vom Benutzer angeforderten Informationen zu empfangen. Die zurückgegebene spezifische Struktur hängt von der in dwInfoLevel angegebenen Informationsebene ab.

[in, out] lpBufferSize

Zeiger auf die Größe des lpBuffer-Puffers in Bytes. Wenn der Aufruf fehlschlägt, weil der Puffer nicht groß genug ist, wird dieser Speicherort verwendet, um die erforderliche Puffergröße zurückzugeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, sollte sie WN_SUCCESS zurückgeben. Andernfalls sollte ein Fehlercode zurückgegeben werden, der einer der folgenden sein kann.

Rückgabecode	Beschreibung
WN_BAD_LOCALNAME	Der an lpLocalPath übergebene Wert ist ungültig.
WN_NOT_CONNECTED	Der an lpLocalPath übergebene Wert ist kein umgeleitetes Gerät.
WN_MORE_DATA	Der Puffer ist zu klein.
WN_NO_NETWORK	Das Netzwerk ist nicht vorhanden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	npapi.h

Freigeben über