NPGetResourceParent-Funktion (npapi.h)

Artikel
02/29/2024

Ruft das übergeordnete Element einer angegebenen Netzwerkressource in der Suchhierarchie ab. Diese Funktion wird in der Regel für Ressourcen aufgerufen, die vom gleichen Anbieter aus vorherigen Aufrufen von NPEnumResource oder NPGetResourceInformation zurückgegeben wurden.

Syntax

DWORD NPGetResourceParent(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize
);

Parameter

[in] lpNetResource

Zeiger auf die Netzwerkressource, deren übergeordneter Name erforderlich ist. Die NETRESOURCE könnte aus einem vorherigen Aufruf von NPEnumResource oder NPGetResourceInformation abgerufen oder vom Aufrufer erstellt worden sein.

Das Feld lpRemoteName gibt den Remotenamen der Netzwerkressource an, deren übergeordnetes Element erforderlich ist.

Das Feld lpProvider gibt den anbieter an, der aufgerufen werden soll. Dies muss angegeben werden.

Das Feld dwType wird ausgefüllt, wenn das aufrufende Programm seinen Wert kennt. Andernfalls ist sie auf NULL festgelegt.

Alle anderen Felder in NETRESOURCE werden ignoriert und nicht initialisiert.

[out] lpBuffer

Zeiger auf einen Puffer zum Empfangen des Ergebnisses. Hierbei handelt es sich um eine einzelne NETRESOURCE-Struktur , die die übergeordnete Ressource darstellt. Die Felder lpRemoteName, lpProvider, dwType, dwDisplayType und dwUsage werden zurückgegeben. alle anderen Felder sind auf NULL festgelegt.

Die Ausgabe lpRemoteName sollte das gleiche Format aufweisen wie das format, das von einer Enumeration von NPEnumResource zurückgegeben wird, damit der Aufrufer einen Zeichenfolgenvergleich durchführen kann, der die Groß-/Kleinschreibung berücksichtigt, um zu bestimmen, ob die übergeordnete Ressource mit der von NPEnumResource zurückgegebenen Ressource identisch ist. Wenn die Eingaberessource syntaktisch über ein übergeordnetes Element verfügt, kann der Anbieter sie zurückgeben, ohne zu bestimmen, ob die Eingaberessource oder ihr übergeordnetes Element tatsächlich vorhanden ist. Wenn eine Ressource kein übergeordnetes Durchsuchen im Netzwerk aufweist, wird lpRemoteName als NULL zurückgegeben.

Das RESOURCEUSAGE_CONNECTABLE Bit im zurückgegebenen dwUsage-Feld gibt nicht unbedingt an, dass die Ressource derzeit mit verbunden werden kann, nur dass die Ressource verbunden ist, wenn sie im Netzwerk verfügbar ist.

[in, out] lpBufferSize

Zeiger auf eine Position, die die Größe des Puffers in Bytes angibt, auf den der lpBuffer-Parameter verweist. Wenn der Puffer für das Ergebnis zu klein ist, platziert die Funktion die erforderliche Puffergröße an dieser Stelle und gibt den Fehler WN_MORE_DATA zurück.

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_MORE_DATA	Der Eingabepuffer ist zu klein.
WN_BAD_NETNAME	Dieser Anbieter besitzt nicht die von lpNetResource angegebene Ressource (oder die Ressource ist syntaktisch ungültig).
WN_BAD_VALUE	Entweder dwUsage oder dwType ist ungültig, oder es ist eine falsche Kombination von Parametern angegeben (z. B. ist lpRemoteName syntaktisch ungültig für dwType).
WN_NOT_AUTHENTICATED	Der Aufrufer wurde nicht beim Netzwerk authentifiziert.
WN_ACCESS_DENIED	Der Aufrufer wurde beim Netzwerk authentifiziert, verfügt aber nicht über ausreichende Berechtigungen.

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