NPGetResourceParent-Funktion (npapi.h)

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 von vorherigen Aufrufen von NPEnumResource oder NPGetResourceInformation zurückgegeben wurden.

Syntax

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

Die Parameter

[in] lpNetResource

Zeigen Sie auf die Netzwerkressource, deren übergeordneter Name erforderlich ist. Die NETRESOURCE konnte 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 LpProvider-Feld gibt den anbieter an, der aufgerufen werden soll. Dies muss angegeben werden.

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

Alle anderen Felder in NETRESOURCE werden ignoriert und nicht initialisiert.

[out] lpBuffer

Zeigen Sie auf einen Puffer, um das Ergebnis zu erhalten, bei dem es sich um eine einzelne NETRESOURCE-Struktur handelt, die die übergeordnete Ressource darstellt. Die Felder "lpRemoteName", "lpProvider", "dwType", "dwDisplayType" und "dwUsage " werden zurückgegeben. Alle anderen Felder sind auf NULL festgelegt.

The output lpRemoteName should be in the same format as that returned from an enumeration by NPEnumResource, so that the caller can perform a case-sensitive string comparison to determine whether the parent resource is the same as one returned by NPEnumResource. Wenn die Eingaberessource syntaktisch über ein übergeordnetes Element verfügt, kann der Anbieter sie zurückgeben, ohne zu bestimmen, ob die Eingaberessource oder das übergeordnete Element tatsächlich vorhanden ist. Wenn eine Ressource kein übergeordnetes Durchsuchen im Netzwerk hat, wird lpRemoteName als NULL zurückgegeben.

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

[in, out] lpBufferSize

Zeigen Sie 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 Position 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 eine der folgenden Sein kann.

Anforderungen