다음을 통해 공유

FSCTL_CREATE_OR_GET_OBJECT_ID IOCTL(winioctl.h)

  • 아티클

지정된 파일 또는 디렉터리에 대한 개체 식별자를 검색합니다. 개체 식별자가 없으면 FSCTL_CREATE_OR_GET_OBJECT_ID를 사용하여 만듭니다.

이 작업을 수행하려면 다음 매개 변수를 사용하여 DeviceIoControl 함수를 호출합니다.

BOOL DeviceIoControl(
  (HANDLE) hDevice,              // handle to device
  FSCTL_CREATE_OR_GET_OBJECT_ID, // dwIoControlCode
  NULL,                          // lpInBuffer
  0,                             // nInBufferSize
  (LPVOID) lpOutBuffer,          // output buffer
  (DWORD) nOutBufferSize,        // size of output buffer
  (LPDWORD) lpBytesReturned,     // number of bytes returned
  (LPOVERLAPPED) lpOverlapped    // OVERLAPPED structure
);

설명

개체 식별자는 파일 및 디렉터리를 추적하는 데 사용됩니다. 대부분의 애플리케이션에는 표시되지 않으며 애플리케이션에서 수정해서는 안 됩니다. 개체 식별자를 수정하면 파일의 일부에서 전체 데이터 볼륨까지 데이터가 손실됩니다.

이 작업은 개체에 아직 없는 경우 개체 식별자를 만듭니다. 개체 식별자가 있는지 테스트하고 개체 식별자가 있는지 검색하려면 FSCTL_GET_OBJECT_ID 작업을 사용합니다. 개체 식별자가 있는지 먼저 테스트하지 않고 만들려면 FSCTL_SET_OBJECT_ID 작업을 사용합니다.

Windows Server 2012 이 함수는 다음 기술에서 지원됩니다.

기술 지원됨
SMB(서버 메시지 블록) 3.0 프로토콜 Yes
SMB 3.0 TFO(투명 장애 조치(failover)) Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 Yes
CsvFS(클러스터 공유 볼륨 파일 시스템) Yes
ReFS(Resilient File System) No

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 winioctl.h(Windows.h 포함)

추가 정보