WNetGetResourceParentA-Funktion (winnetwk.h)
Die WNetGetResourceParent-Funktion gibt das übergeordnete Element einer Netzwerkressource in der Netzwerksuchehierarchie zurück. Das Durchsuchen beginnt am Speicherort der angegebenen Netzwerkressource.
Rufen Sie die Funktionen WNetGetResourceInformation und WNetGetResourceParent auf, um die Netzwerkhierarchie nach oben zu verschieben. Rufen Sie die WNetOpenEnum-Funktion auf, um die Hierarchie nach unten zu verschieben.
Syntax
DWORD WNetGetResourceParentA(
[in] LPNETRESOURCEA lpNetResource,
[out] LPVOID lpBuffer,
[in, out] LPDWORD lpcbBuffer
);
Parameter
[in] lpNetResource
Zeiger auf eine NETRESOURCE-Struktur , die die Netzwerkressource angibt, für die der übergeordnete Name erforderlich ist.
Geben Sie die Member der NETRESOURCE-Eingabestruktur wie folgt an. Der Aufrufer kennt in der Regel die Werte, die nach vorherigen Aufrufen von WNetGetResourceInformation oder WNetGetResourceParent für die Elemente lpProvider und dwType bereitgestellt werden sollen.
Alle anderen Member der NETRESOURCE-Struktur werden ignoriert.
[out] lpBuffer
Zeiger auf einen Puffer zum Empfangen einer einzelnen NETRESOURCE-Struktur , die die übergeordnete Ressource darstellt. Die Funktion gibt die Elemente lpRemoteName, lpProvider, dwType, dwDisplayType und dwUsage der -Struktur zurück. alle anderen Member sind auf NULL festgelegt.
Das lpRemoteName-Element verweist auf den Remotenamen für die übergeordnete Ressource. Dieser Name verwendet dieselbe Syntax wie der, der von einer Enumeration von der WNetEnumResource-Funktion zurückgegeben wird. Der Aufrufer kann einen Zeichenfolgenvergleich durchführen, um zu bestimmen, ob die WNetGetResourceParent-Ressource mit der von WNetEnumResource zurückgegebenen Ressource identisch ist. Wenn die Eingaberessource in keinem der Netzwerke über ein übergeordnetes Element verfügt, wird der lpRemoteName-Member als NULL zurückgegeben.
Das Vorhandensein des RESOURCEUSAGE_CONNECTABLE Bits im dwUsage-Element gibt an, dass Sie eine Verbindung mit der übergeordneten Ressource herstellen können, aber nur, wenn sie im Netzwerk verfügbar ist.
[in, out] lpcbBuffer
Zeiger auf einen Speicherort, der beim Eintrag die Größe des lpBuffer-Puffers in Bytes angibt. Wenn der Puffer zu klein ist, um das Ergebnis zu speichern, empfängt dieser Speicherort die erforderliche Puffergröße, und die Funktion gibt ERROR_MORE_DATA zurück.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.
Rückgabecode | Beschreibung |
---|---|
|
Der Aufrufer hat keinen Zugriff auf die Netzwerkressource. |
|
Das lpRemoteName-Eingabeelement ist keine vorhandene Netzwerkressource für ein Netzwerk. |
|
Das lpProvider-Element stimmt mit keinem installierten Netzwerkanbieter überein. |
|
Der Puffer, auf den der lpBuffer-Parameter verweist, ist zu klein. |
|
Der Aufrufer verfügt nicht über die erforderlichen Berechtigungen, um den Namen des übergeordneten Elements abzurufen. |
Hinweise
Die WNetGetResourceParent-Funktion wird in der Regel in Verbindung mit der WNetGetResourceInformation-Funktion verwendet, um einen von einem Benutzer eingegebenen Netzwerkpfad zu analysieren und zu interpretieren.
Im Gegensatz zur WNetGetResourceInformation-Funktion gibt die WNetGetResourceParent-Funktion , wenn die Ressource ein übergeordnetes Element in ihrer Syntax enthält, das übergeordnete Element zurück, unabhängig davon, ob die Ressource tatsächlich vorhanden ist. WNetGetResourceParent sollte in der Regel nur von Anwendungen verwendet werden, die dem Benutzer Netzwerkressourcen hierarchisch anzeigen. Die Windows-Explorer und das Dialogfeld Datei öffnen sind zwei bekannte Beispiele für diesen Anwendungstyp. Beachten Sie, dass keine Annahmen über den Typ der zurückgegebenen Ressource getroffen werden sollten.
Sie können die Funktion WNetEnumResource, WNetGetResourceInformation oder WNetGetResourceParent aufrufen, um Informationen aus der NETRESOURCE-Struktur zurückzugeben. Sie können auch Netzwerkressourceninformationen mithilfe der Elemente der NETRESOURCE-Struktur erstellen.
Ein Beispiel für eine unangemessene Verwendung von WNetGetResourceParent ist die Bestimmung des Namens der Domäne, zu der ein angegebener Server gehört. Die Funktion gibt möglicherweise den richtigen Domänennamen für einige Netzwerke zurück, in denen Domänen direkt über Servern in der Suchhierarchie angezeigt werden. Die Funktion gibt falsche Ergebnisse für andere Netzwerke zurück.
Hinweis
Der winnetwk.h-Header definiert WNetGetResourceParent als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winnetwk.h |
Bibliothek | Mpr.lib |
DLL | Mpr.dll |