다음을 통해 공유

RpcNsMgmtInqExpAge 함수(rpcnsi.h)

  • 아티클

RpcNsMgmtInqExpAge 함수는 이름 서비스 데이터의 로컬 복사본에 대한 전역 만료 기간을 반환합니다.

참고 이 함수는 Windows Vista 이상 운영 체제에서 지원되지 않습니다.
 

구문

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

매개 변수

ExpirationAge

기본 만료 기간(초)에 대한 포인터입니다. 이 값은 모든 이름 서비스 다음 작업에서 사용됩니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

RpcNsMgmtInqExpAge 함수는 애플리케이션에서 사용 중인 만료 기간을 반환합니다. 만료 기간은 특성에 대한 애플리케이션의 요청이 로컬 복사본을 업데이트해야 하기 전에 name-service 특성의 데이터 로컬 복사본이 존재할 수 있는 시간(초)입니다. 애플리케이션 실행이 시작되면 RPC 런타임 라이브러리는 기본 만료 기간을 2시간으로 지정합니다. 기본값은 애플리케이션에 대한 전역입니다.

만료 기간은 포인터 다음 작업(이름 서비스 특성에서 데이터를 읽는)에서 사용됩니다. 다음 작업은 일반적으로 애플리케이션에서 요청하는 특성 데이터의 로컬 복사본을 찾는 것으로 시작됩니다. 로컬 복사본이 없는 경우 다음 작업은 이름 서비스 데이터베이스에서 새 특성 데이터가 포함된 복사본을 만듭니다. 로컬 복사본이 이미 있는 경우 작업은 실제 기간을 애플리케이션에서 사용하는 만료 기간과 비교합니다. 실제 기간이 만료 기간을 초과하면 작업은 자동으로 새 특성 데이터로 로컬 복사본을 업데이트하려고 시도합니다. 업데이트가 불가능한 경우 이전 로컬 데이터가 그대로 유지되고 다음 작업이 실패합니다.

애플리케이션은 일반적으로 기본 만료 기간만 사용해야 합니다. 그러나 특별한 경우 애플리케이션은 RpcNsMgmtSetExpAge를 호출하여 사용자가 제공한 전역 만료 기간을 기본값으로 대체할 수 있습니다. RpcNsMgmtInqExpAge 함수는 기본값이든 사용자가 제공한 값이든 관계없이 현재 전역 만료 기간을 반환합니다. 애플리케이션은 RpcNsMgmtHandleSetExpAge 함수를 호출하여 전역 만료 기간을 일시적으로 재정의할 수도 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 rpcnsi.h(Rpc.h 포함)
라이브러리 Rpcns4.lib
DLL Rpcns4.dll

추가 정보

RpcNsMgmtHandleSetExpAge

RpcNsMgmtSetExpAge