ResUtilGetResourceDependentIPAddressProps-Funktion (resapi.h)

Artikel
08/25/2023

Ruft die privaten Eigenschaften der ersten IP-Adressabhängigkeit ab, die für eine angegebene Ressource gefunden wurde. Der PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS-Typs definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilGetResourceDependentIPAddressProps(
  [in]      HRESOURCE hResource,
  [out]     LPWSTR    pszAddress,
  [in, out] DWORD     *pcchAddress,
  [out]     LPWSTR    pszSubnetMask,
  [in, out] DWORD     *pcchSubnetMask,
  [out]     LPWSTR    pszNetwork,
  [in, out] DWORD     *pcchNetwork
);

Parameter

[in] hResource

Behandeln Sie die Ressource, um Abhängigkeiten abzufragen.

[out] pszAddress

Ausgabepuffer zum Zurückgeben des Werts der privaten Address-Eigenschaft .

[in, out] pcchAddress

Gibt bei der Eingabe die Größe des Puffers pszAddress als Anzahl von WCHARs an. Gibt in der Ausgabe die Größe der resultierenden Daten als Anzahl von WCHARs an, die den beendenden NULL-Wert enthält.

[out] pszSubnetMask

Ausgabepuffer zum Zurückgeben des Werts der privaten SubnetMask-Eigenschaft .

[in, out] pcchSubnetMask

Gibt bei der Eingabe die Größe des pszSubnetMask-Puffers als Anzahl von WCHARs an. Gibt in der Ausgabe die Größe der resultierenden Daten als Anzahl von WCHARs an, die den beendenden NULL-Wert enthält.

[out] pszNetwork

Ausgabepuffer zum Zurückgeben des Werts der privaten Network-Eigenschaft .

[in, out] pcchNetwork

Gibt bei der Eingabe die Größe des pszNetwork-Puffers als Anzahl von WCHARs an. Gibt in der Ausgabe die Größe der resultierenden Daten als Anzahl von WCHARs an, die den beendenden NULL-Wert enthält.

Windows Server 2008 R2 und Windows Server 2008: Dieser Parameter wird vor Windows Server 2012 als pcch bezeichnet.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS (0) zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden sind mögliche Fehlercodes aufgeführt.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_NO_MORE_ITEMS 259 (0x103)	In der Liste der Abhängigkeiten der angegebenen Ressource wurde keine IP-Adressabhängigkeit gefunden.
ERROR_RESOURCE_NOT_PRESENT 4316 (0x10DC)	Es wurde keine IP-Adressabhängigkeit gefunden.
ERROR_MORE_DATA 234 (0xEA)	Die Größe eines der Puffer war zu klein, um die resultierenden Daten zu speichern.

Hinweise

Rufen Sie ResUtilGetResourceDependentIPAddressProps nicht über eine Ressourcen-DLL-Einstiegspunktfunktion auf. ResUtilGetResourceDependentIPAddressProps können sicher von einem Workerthread aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Die ResUtilGetResourceDependentIPAddressProps-Funktion gibt nur die privaten Eigenschaften für die erste IPv4-Ressource zurück, von der die Ressource direkt abhängt. Die Funktion untersucht keine indirekten Abhängigkeiten (z. B. eine Ressource, die von einer Netzwerknamenressource abhängig ist, die wiederum von einer IP-Adressressource abhängig ist), IPv6-Adressressourcen oder IPv6-Tunneladressenressourcen .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.lib
DLL	ResUtils.dll