다음을 통해 공유


NtOpenThread 함수

[이 함수는 추가 공지 없이 Windows에서 변경되거나 제거될 수 있습니다. 대신 OpenThread 함수를 사용합니다.]

액세스 권한이 지정된 스레드 개체에 대한 핸들을 엽니다.

구문

NTSTATUS NtOpenThread(
  _Out_ PHANDLE            ThreadHandle,
  _In_  ACCESS_MASK        DesiredAccess,
  _In_  POBJECT_ATTRIBUTES ObjectAttributes,
  _In_  PCLIENT_ID         ClientId
);

매개 변수

ThreadHandle [out]

스레드 개체 핸들을 수신하는 변수에 대한 포인터입니다.

DesiredAccess [in]

스레드 개체에 대해 원하는 형식의 액세스를 제공하는 ACCESS_MASK 데이터 형식입니다.

ObjectAttributes [in]

OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 구조체의 ObjectName 멤버는 NULL이어야 합니다.

Windows Server 2003 및 Windows XP: 이 구조체의 ObjectName 멤버는 개체 이름을 가리킬 수 있습니다. ObjectName이 NULL이 아닌 경우 ClientId 매개 변수는 NULL이어야 합니다.

ClientId [in]

스레드를 열 스레드를 식별하는 CLIENT_ID 구조체에 대한 포인터입니다.

Windows Server 2003 및 Windows XP: 스레드를 열 스레드를 식별하는 CLIENT_ID 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 매개 변수가 NULL이 아닌 경우 ObjectAttributes 매개 변수가 가리키는 구조체의 ObjectName 멤버는 NULL이어야 합니다.

반환 값

NTSTATUS 또는 오류 코드를 반환합니다.

NTSTATUS 오류 코드의 양식과 중요성은 WDK에서 사용할 수 있는 Ntstatus.h 헤더 파일에 나열되며 WDK 설명서에 설명되어 있습니다.

설명

이 함수에는 연결된 헤더 파일이 없습니다. 연결된 가져오기 라이브러리인 Ntdll.lib는 WDK에서 사용할 수 있습니다. LoadLibraryGetProcAddress 함수를 사용하여 Ntdll.dll 동적으로 연결할 수도 있습니다.

요구 사항

요구 사항
DLL
Ntdll.dll