다음을 통해 공유

RegisterAppInstance 함수(smbclnt.h)

프로세스에 대한 AppInstance ID를 등록합니다.

통사론

DWORD RegisterAppInstance(
  [in] HANDLE ProcessHandle,
  [in] GUID   *AppInstanceId,
  [in] BOOL   ChildrenInheritAppInstance
);

매개 변수

[in] ProcessHandle

현재 프로세스 또는 AppInstanceId태그를 지정할 원격 프로세스에 대한 프로세스 핸들입니다. 원격 프로세스에 태그를 지정하려면 핸들에 해당 프로세스에 대한 PROCESS_TERMINATE 액세스 권한이 있어야 합니다.

[in] AppInstanceId

GUID애플리케이션 인스턴스 ID입니다.

[in] ChildrenInheritAppInstance

ProcessHandle지정한 프로세스에 의해 생성된 자식 프로세스에 태그를 지정하는 TRUE. 그렇지 않으면 FALSE.

반환 값

반환 코드 묘사
ERROR_NOT_ENOUGH_MEMORY
 CCF 필터가 이 작업을 수행하기 위해 적절한 캐시 개체를 할당하지 못했습니다.
ERROR_ACCESS_DENIED
 ProcessHandle 지정된 프로세스에 태그를 지정하려는 현재 프로세스에는 해당 프로세스에 대한 PROCESS_TERMINATE 액세스 권한이 없습니다.
ERROR_INVALID_PARAMETER
 ProcessHandle 프로세스에 대한 핸들이 아닙니다.
ERROR_NOT_FOUND
 CCF 미니 필터를 찾을 수 없습니다.
ERROR_OBJECT_ALREADY_EXISTS
 동일한 프로세스에 대해 또 다른 AppInstanceGUID 제공됩니다. 즉, RegisterAppInstance 함수가 두 번 호출되었거나 애플리케이션이 두 번 등록되었습니다.

발언

RegisterAppInstance 함수는 CCF 미니 필터에 대한 IOCTL_CCF_REGISTER_APPINSTANCE 호출을 실행합니다. 이 함수는 AppInstanceGUID, 프로세스 핸들 및 태그가 지정된 자식 프로세스를 프로세스 핸들을 AppInstanceId매핑하는 CCF 캐시에 전달합니다.

다른 프로세스에 태그를 지정하기 위해 발급된 IOCTL은 현재 프로세스가 대상 프로세스에 PROCESS_TERMINATE 액세스 권한이 있는지 확인합니다.

요구 사항

요구 값
지원되는 최소 클라이언트 지원되지 않는 항목
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 Windows
헤더 smbclnt.h
라이브러리 NTLanMan.lib
DLL NTLanMan.dll

참고 항목

장애 조치(failover) 클러스터 리소스 관리 함수

  • Last updated on