CF_CALLBACK_INFO 구조체(cfapi.h)
콜백 유형, 콜백을 트리거하는 사용자 프로세스 및 콜백이 요청된 파일에 대한 기본 정보와 같은 일반적인 콜백 정보를 포함합니다.
구문
typedef struct CF_CALLBACK_INFO {
DWORD StructSize;
CF_CONNECTION_KEY ConnectionKey;
LPVOID CallbackContext;
PCWSTR VolumeGuidName;
PCWSTR VolumeDosName;
DWORD VolumeSerialNumber;
LARGE_INTEGER SyncRootFileId;
LPCVOID SyncRootIdentity;
DWORD SyncRootIdentityLength;
LARGE_INTEGER FileId;
LARGE_INTEGER FileSize;
LPCVOID FileIdentity;
DWORD FileIdentityLength;
PCWSTR NormalizedPath;
CF_TRANSFER_KEY TransferKey;
UCHAR PriorityHint;
PCORRELATION_VECTOR CorrelationVector;
CF_PROCESS_INFO *ProcessInfo;
CF_REQUEST_KEY RequestKey;
} CF_CALLBACK_INFO;
멤버
StructSize
CF_CALLBACK_INFO 크기입니다.
ConnectionKey
동기화 공급자가 관리하는 동기화 루트에 대해 CfConnectSyncRoot 에서 만든 불투명 핸들입니다. ConnectionKey 는 편의를 위해 반환되므로 동기화 공급자가 수동으로 추적할 필요가 없습니다.
CallbackContext
동기화 공급자가 동기화 루트 연결 시간에 제공하는 불투명 Blob을 가리킵니다. CallbackContext 는 편의를 위해 반환되므로 동기화 공급자가 수동으로 추적할 필요가 없습니다.
VolumeGuidName
서비스할 자리 표시자 파일/디렉터리가 있는 볼륨의 GUID 이름입니다. "\?\Volume{GUID}" 형식입니다.
VolumeDosName
볼륨의 DOS 드라이브 문자는 "X:" 형식입니다. 여기서 X 는 드라이브 문자입니다.
VolumeSerialNumber
볼륨의 일련 번호입니다.
SyncRootFileId
서비스할 자리 표시자 파일 또는 디렉터리가 있는 동기화 루트의 볼륨 전체 고유 ID인 64비트 파일 시스템이 유지 관리됩니다.
SyncRootIdentity
동기화 루트 등록 시간에 동기화 공급자가 제공하는 불투명 Blob을 가리킵니다.
SyncRootIdentityLength
SyncRootIdentity의 길이(바이트)입니다.
FileId
서비스할 자리 표시자 파일 또는 디렉터리의 볼륨 전체 고유 ID가 유지 관리되는 64비트 파일 시스템입니다.
FileSize
서비스할 자리 표시자 파일의 논리적 크기입니다. 콜백의 제목이 디렉터리인 경우 항상 0 입니다.
FileIdentity
동기화 공급자가 자리 표시자 생성/변환/업데이트 시간에 제공하는 불투명 Blob을 가리킵니다.
FileIdentityLength
FileIdentity의 길이(바이트)입니다.
NormalizedPath
VolumeGuidName/VolumeDosName으로 식별된 볼륨에서 서비스할 자리 표시자 파일 또는 디렉터리의 절대 경로입니다. 볼륨의 루트 디렉터리에서 시작합니다. 자세한 내용은 설명 섹션을 참조하세요.
TransferKey
서비스할 자리 표시자 파일/디렉터리에 대한 불투명 핸들입니다. 동기화 공급자는 파일/디렉터리에서 원하는 작업을 수행하려면 CfExecute 호출에 다시 전달해야 합니다.
PriorityHint
사용자에게 가장 응답성이 뛰어난 환경을 제공하기 위해 한 페치의 상대적 우선 순위를 다른 페치에 비해 설명하기 위해 동기화 공급자에게 지정된 숫자 배율입니다. 값은 (가능한 가장 낮은 우선 순위)에서 0 (가능한 가장 높은 우선 순위) 15 까지 다양하지만, 그렇지 않으면 값에 특정 의미가 없습니다. 필터는 조건에 따라 우선 순위 힌트를 선택하는 방법을 조정할 수 있습니다. 동기화 공급자는 원하는 힌트를 자유롭게 사용할 수 있습니다.
CorrelationVector
선택적 상관 관계 벡터입니다.
ProcessInfo
이 콜백을 트리거하는 사용자 프로세스에 대한 정보를 포함하는 CF_PROCESS_INFO 구조를 가리킵니다. 동기화 공급자가 동기화 루트 연결 시간에 CF_CONNECT_FLAG_REQUIRE_PROCESS_INFO 지정하는 경우에만 존재합니다.
RequestKey
TransferKey에 표시된 대로 특정 클라우드 파일에서 클라우드 파일 작업을 고유하게 식별하는 불투명 ID입니다. 동기화 공급자는 이 필드를 해석할 필요가 없습니다. 동기화 공급자의 유일한 요구 사항은 CF_OPERATION_INFO 그대로 전송하는 것입니다.
설명
다음이 모두 true인 경우 파일 이름은 정규화된 것으로 간주됩니다.
- 사용자가 파일 ID로 파일을 열었지만 전체 경로에 대한 트래버스 권한이 없는 한 볼륨 이름을 포함하여 파일에 대한 전체 디렉터리 경로를 포함합니다. (자세한 내용은 FltGetFileNameInformation을 참조하세요.)
- 볼륨 이름은 볼륨의 비영구 디바이스 개체 이름(예: "\Device\HarddiskVolume1")입니다.
- 모든 짧은 이름은 해당하는 긴 이름으로 확장됩니다.
- 모든 후행 ":$DATA" 또는 "::$DATA" 문자열은 스트림 이름에서 제거됩니다.
- 모든 탑재 지점이 확인됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 머리글 | cfapi.h |