CfGetSyncRootInfoByHandle-Funktion (cfapi.h)

Ruft verschiedene Merkmale des Synchronisierungsstamms ab, der eine durch ein Dateihandle angegebene Datei enthält.

Syntax

HRESULT CfGetSyncRootInfoByHandle(
  [in]            HANDLE                  FileHandle,
  [in]            CF_SYNC_ROOT_INFO_CLASS InfoClass,
  [out]           PVOID                   InfoBuffer,
  [in]            DWORD                   InfoBufferLength,
  [out, optional] DWORD                   *ReturnedLength
);

Parameter

[in] FileHandle

Handle der Datei unter dem Synchronisierungsstamm, deren Informationen abgefragt werden sollen.

[in] InfoClass

Typen von Synchronisierungsstamminformationen.

[out] InfoBuffer

Ein Zeiger auf einen Puffer, der die Synchronisierungsstamminformationen empfängt.

[in] InfoBufferLength

Länge des InfoBuffers in Bytes.

[out, optional] ReturnedLength

Die Anzahl der im InfoBuffer zurückgegebenen Bytes.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird zurückgegeben S_OK. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Im Gegensatz zu den meisten Platzhalter-APIs, die ein Dateihandle verwenden, ändert dieser die Datei in keiner Weise, daher erfordert fileHandle nur READ_ATTRIBUTES Zugriff.

Wenn sich die Datei nicht unter einem Clouddateisynchronisierungsstamm befindet, schlägt die API fehl. Bei Erfolg werden Informationen entsprechend der spezifischen angeforderten InfoClass zurückgegeben.

Anforderungen

Weitere Informationen

CfGetSyncRootInfoByPath