CM_Get_Res_Des_Data_Ex-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Res_Des_Data .]

Die funktion CM_Get_Res_Des_Data_Ex ruft die informationen ab, die in einem Ressourcendeskriptor auf einem lokalen computer oder einem Remotecomputer gespeichert sind.

Syntax

CMAPI CONFIGRET CM_Get_Res_Des_Data_Ex(
  [in]           RES_DES  rdResDes,
  [out]          PVOID    Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] rdResDes

Vom Aufrufer bereitgestelltes Handle für einen Ressourcendeskriptor, der durch einen vorherigen Aufruf von CM_Get_Next_Res_Des_Ex abgerufen wurde.

[out] Buffer

Adresse eines Puffers zum Empfangen des Inhalts eines Ressourcendeskriptors. Die erforderliche Puffergröße sollte durch Aufrufen von CM_Get_Res_Des_Data_Size_Ex abgerufen werden.

[in] BufferLen

Vom Aufrufer bereitgestellte Länge des durch Puffer angegebenen Puffers.

[in] ulFlags

Nicht verwendet, muss null sein.

[in, optional] hMachine

Vom Aufrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen wurde.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Informationen, die in dem von Buffer bereitgestellten Puffer zurückgegeben werden, werden basierend auf dem Ressourcentyptyp formatiert, der beim Aufrufen CM_Get_Next_Res_Des_Ex zum Abrufen des Ressourcendeskriptorhandles in der Beschreibung von CM_Add_Res_Des_Ex aufgeführt ist.

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und späteren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn Sie unter diesen Versionen von Windows ausgeführt werden.

Anforderungen

Weitere Informationen

CM_Get_Res_Des_Data