RpcNsMgmtSetExpAge 함수(rpcnsi.h)

RpcNsMgmtSetExpAge 함수는 이름 서비스 데이터의 로컬 복사본에 대한 애플리케이션의 전역 만료 기간을 수정합니다.

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

 

구문

RPC_STATUS RpcNsMgmtSetExpAge(
  unsigned long ExpirationAge
);

매개 변수

ExpirationAge

기본 만료 기간(초)에 대한 포인터입니다. 이 값은 모든 이름 서비스-다음 작업에서 사용됩니다. 만료 기간이 0이면 로컬 이름 서비스 데이터가 즉시 업데이트됩니다.

만료 기간을 RPC 할당 기본값인 2시간으로 다시 설정하려면 RPC_C_NS_DEFAULT_EXP_AGE 값을 지정합니다.

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.
RPC_S_NAME_SERVICE_UNAVAILABLE	이름 서비스를 사용할 수 없습니다.

 

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.

 

설명

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

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

만료 기간을 작은 값으로 설정하면 포인터 다음 작업이 애플리케이션에서 요청한 이름 서비스 특성에 대한 로컬 데이터를 자주 업데이트합니다. 예를 들어 만료 기간을 0으로 설정하면 모든 다음 작업이 애플리케이션에서 요청한 name-service 특성에 대한 로컬 데이터를 업데이트합니다. 따라서 만료 연령을 작게 설정하면 애플리케이션의 성능 문제가 발생하며 네트워크 트래픽이 증가할 수 있습니다. 또한 애플리케이션이 원격 이름 서비스 서버를 사용하는 경우 만료 기간이 적으면 모든 애플리케이션의 네트워크 성능에 부정적인 영향을 줄 수 있습니다.

요구 사항

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

추가 정보

RpcNsMgmtHandleSetExpAge