RtmLockDestination 함수(rtmv2.h)

RtmLockDestination 함수는 라우팅 테이블의 대상을 잠그거나 잠금 해제합니다. 불투명 포인터를 변경하는 동안 대상을 보호하려면 이 함수를 사용합니다.

구문

DWORD RtmLockDestination(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              Exclusive,
  [in] BOOL              LockDest
);

매개 변수

[in] RtmRegHandle

RtmRegisterEntity에 대한 이전 호출에서 얻은 클라이언트에 대한 핸들입니다.

[in] DestHandle

잠글 대상에 대한 핸들입니다.

[in] Exclusive

배타적(TRUE) 또는 공유(FALSE) 모드에서 대상을 잠그거나 잠금 해제할지 여부를 지정합니다.

[in] LockDest

대상을 잠그거나 잠금 해제할지 여부를 지정합니다. 대상을 잠그려면 TRUE 를 지정합니다. FALSE 를 지정하여 잠금을 해제합니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

값	의미
ERROR_ACCESS_DENIED	호출 클라이언트는 이 대상을 소유하지 않습니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다.

 

 

설명

이 함수는 연결된 경로도 잠습니다. 잠금이 해제될 때까지 다른 클라이언트가 대상 및 연결된 경로에 액세스할 수 없으므로 오랫동안 대상을 잠그지 마세요.

클라이언트는 대상에 대한 정보를 읽을 때 이 함수를 사용할 수도 있지만 클라이언트의 읽기 작업 중에 변경되는 것을 방지할 수도 있습니다. 이 경우 RtmGetDestInfo 를 대신 사용하는 것이 좋습니다.

이 함수를 사용하는 샘플 코드는 RtmUpdateAndUnlockRoute를 사용하여 경로 업데이트를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	rtmv2.h
라이브러리	Rtm.lib
DLL	Rtm.dll

추가 정보

RtmGetOpaqueInformationPointer