Freigeben über

NPGetUniversalName-Funktion (npapi.h)

  • Artikel

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