ResUtilEnumResourcesEx-Funktion (resapi.h)
Listet alle Ressourcen in einem angegebenen Cluster auf und initiiert einen benutzerdefinierten Vorgang für jede Ressource. Der PRESUTIL_ENUM_RESOURCES_EX Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilEnumResourcesEx(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter
);
Parameter
[in] hCluster
Ein Handle für den Cluster, der die zu enumerierenden Ressourcen enthält.
[in, optional] hSelf
Ein optionales Handle für eine Clusterressource. Die Rückruffunktion wird nicht für eine Ressource aufgerufen, die von hSelf identifiziert wird.
[in] lpszResTypeName
Ein optionaler Zeiger auf einen Namen eines Ressourcentyps , der den Bereich der aufzuzählenden Ressourcen einschränkt. Wenn lpszResTypeName angegeben ist, werden nur Ressourcen des angegebenen Typs aufgelistet.
[in] pResCallBack
Ein Zeiger auf eine benutzerdefinierte Funktion, die für jede aufgezählte Ressource aufgerufen wird. Diese Funktion muss der Definition der ResourceCallbackEx-Rückruffunktion entsprechen. Beachten Sie, dass Parameternamen nicht Teil der Definition sind. sie wurden hier aus Gründen der Übersichtlichkeit hinzugefügt.
DWORD (*LPRESOURCE_CALLBACK_EX)(
HCLUSTER hCluster,
HRESOURCE hSelf,
HRESOURCE hEnum,
PVOID pParameter
);
hCluster
Der hCluster-Parameter , der an ResUtilEnumResourcesEx übergeben wird.
hSelf
Der hSelf-Parameter , der an ResUtilEnumResourcesEx übergeben wird. Beachten Sie, dass die Rückruffunktion nie aufgerufen wird, wenn hSelf und hEnum auf dieselbe Ressource verweisen.
hEnum
Ein Handle für die Ressource, die derzeit aufgezählt wird. ResUtilEnumResourcesEx öffnet und schließt dieses Handle automatisch.
pParameter
Ein generischer Puffer, mit dem Sie jede Art von Daten an die Rückruffunktion übergeben können.
[in] pParameter
Ein generischer Puffer, mit dem Sie jede Art von Daten an die Rückruffunktion übergeben können. ResUtilEnumResourcesEx verwendet diesen Parameter überhaupt nicht. Sie übergibt lediglich den Zeiger auf die Rückruffunktion. Ob Sie NULL für den Parameter übergeben können, hängt davon ab, wie die Rückruffunktion implementiert ist.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.
Wenn der Vorgang fehlschlägt, beendet die Funktion sofort die Enumeration und gibt den Wert zurück, der von der Rückruffunktion zurückgegeben wird.
Hinweise
ResUtilEnumResourcesEx ist eine praktische und benutzerfreundliche Alternative zur ClusterResourceEnum-Funktion .
Beispiele
Sehen Sie sich das Beispiel für ResUtilEnumResources an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |
| Bibliothek | ResUtils.lib |
| DLL | ResUtils.dll |