NPGetResourceInformation-Funktion (npapi.h)

Trennt den Teil einer Netzwerkressource, auf den über die WNet-API zugegriffen wird, von dem Teil, auf den über APIs zugegriffen wird, die für den Ressourcentyp spezifisch sind.

Syntax

DWORD NPGetResourceInformation(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize,
  [out]     LPWSTR         *lplpSystem
);

Die Parameter

[in] lpNetResource

Gibt die Netzwerkressource an, für die Informationen erforderlich sind. Das lpRemoteName-Feld gibt den Remotenamen der Ressource an. Das aufrufende Programm sollte die Werte für die Felder lpProvider und dwType ausfüllen, wenn es diese Werte kennt; andernfalls sollten diese Felder auf NULL festgelegt werden. Alle anderen Felder in NETRESOURCE werden ignoriert und nicht initialisiert.

Wenn die lpRemoteName-Zeichenfolge einen Teil enthält, auf den über WNet-APIs und einen Teil zugegriffen wird, auf den über andere System-APIs zugegriffen wird, die für den Ressourcentyp spezifisch sind, sollte die Funktion nur Informationen über den Netzwerkteil der Ressource zurückgeben (mit Ausnahme von lplpSystem, wie weiter unten in diesem Thema beschrieben).

Wenn die Ressource z. B. "\server\share\dir1\dir2" lautet, auf die "\server\share" über WNet-APIs zugegriffen wird und auf "\dir1\dir2" über Dateisystem-APIs zugegriffen wird, sollte der Anbieter überprüfen, ob es sich um den richtigen Anbieter für "\server\share" handelt, aber nicht überprüfen, ob "\dir1\dir2" tatsächlich vorhanden ist.

[out] lpBuffer

Zeigen Sie auf den Puffer, um das Ergebnis zu erhalten. Das erste Feld im Ergebnis ist eine einzelne NETRESOURCE-Struktur und zugeordnete Zeichenfolgen, die diesen Teil der Eingaberessource darstellen, auf den über die WNet-API zugegriffen wird, anstatt System-APIs, die für den Ressourcentyp spezifisch sind. Wenn beispielsweise der Eingabe-Remoteressourcenname "\server\share\dir1\dir2" lautet, enthält die Ausgabe NETRESOURCE Informationen zur Ressource "\server\share". Die Felder "lpRemoteName", "lpProvider", "dwType", "dwDisplayType" und "dwUsage " werden mit Werten zurückgegeben, wobei alle anderen Felder auf NULL festgelegt werden.

Das lpRemoteName-Feld sollte im gleichen Format zurückgegeben werden wie das, das von einer Aufzählung durch die NPEnumResource-Funktion zurückgegeben wird, damit der Aufrufer einen Vergleich zwischen Groß- und Kleinschreibung durchführen kann. Dies ist erforderlich, um festzustellen, ob die Ausgabenetzwerkressource mit einer von NPEnumResource zurückgegebenen Ressource identisch ist.

Der Anbieter sollte keine rein syntaktische Überprüfung durchführen, um festzustellen, ob er der Besitzer der Ressource ist. Dies kann zu falschen Ergebnissen führen, wenn zwei Netzwerke auf dem Client ausgeführt werden und der Anbieter, der die syntaktische Überprüfung durchführt, zuerst aufgerufen wird.

[in, out] lpBufferSize

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

[out] lplpSystem

Bei einer erfolgreichen Rückgabe gibt ein Zeiger auf eine mit Null beendete Zeichenfolge im Ausgabepuffer an, die angibt, dass ein Teil der Ressource, auf die über System-APIs zugegriffen wird, die für den Ressourcentyp spezifisch sind, und nicht über die WNet-API. Wenn kein solcher Teil vorhanden ist, wird lplpSystem auf NULL festgelegt. Wenn beispielsweise der Eingabe-Remoteressourcenname "\server\share\dir" lautete, wird lpRemoteName zurückgegeben, der auf "\server\share" zeigt, und lplpSystem verweist auf "\dir", beide Zeichenfolgen, die im Puffer gespeichert werden, auf "lpBuffer".

Rückgabewert

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

Bemerkungen

Die Enumerationsstruktur kann mithilfe von NPOpenEnum und den zugehörigen Funktionen von einer benannten Netzwerkressource nach unten navigiert werden. Um von einer benannten Ressource nach oben zu navigieren, kann die NPGetResourceInformation-Funktion aufgerufen werden, um Informationen über die Ressource abzurufen, gefolgt von der NPGetResourceParent-Funktion , um den Namen und Typ der übergeordneten Ressource abzurufen.

NPGetResourceInformation bestimmt, ob der angegebene Anbieter der richtige Anbieter ist, um auf eine Anforderung für eine angegebene Netzwerkressource zu antworten. Anschließend werden Informationen zum Ressourcentyp zurückgegeben.

Anforderungen