ResUtilEnumResourcesEx2-Funktion (resapi.h)
Listet alle Ressourcen in einem angegebenen Cluster auf und initiiert einen benutzerdefinierten Vorgang für jede Ressource. Der PRESUTIL_ENUM_RESOURCES_EX2 Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilEnumResourcesEx2(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter,
[in] DWORD dwDesiredAccess
);
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 für eine von hSelf identifizierte Ressource nicht aufgerufen.
[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
[in] Der hCluster-Parameter, der an ResUtilEnumResourcesEx übergeben wird.
hSelf
[in] Der an ResUtilEnumResourcesEx übergebene hSelf-Parameter. Beachten Sie, dass die Rückruffunktion nie aufgerufen wird, wenn hSelf und hEnum auf dieselbe Ressource verweisen.
hEnum
[in] Ein Handle für die Ressource, die gerade aufgelistet wird. ResUtilEnumResourcesEx öffnet und schließt dieses Handle automatisch.
pParameter
[in] 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, sondern übergibt lediglich den Zeiger an die Rückruffunktion. Ob Sie NULL für den Parameter übergeben können, hängt davon ab, wie die Rückruffunktion implementiert wird.
[in] dwDesiredAccess
Die angeforderten Zugriffsberechtigungen. Dies kann eine beliebige Kombination aus GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) oder MAXIMUM_ALLOWED (0x02000000) sein. Wenn dieser Wert null (0) ist, wird möglicherweise ein nicht definierter Fehler zurückgegeben. Die Verwendung GENERIC_ALL entspricht dem Aufrufen von ResUtilEnumResourcesEx.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.
Wenn der Vorgang fehlschlägt, hält die Funktion die Enumeration sofort an und gibt den von der Rückruffunktion zurückgegebenen Wert zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |
| Bibliothek | ResUtils.lib |
| DLL | ResUtils.dll |