RpcNsMgmtEntryDeleteA 함수(rpcnsi.h)

RpcNsMgmtEntryDelete 함수는 이름 service-database 항목을 삭제합니다.

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

 

구문

RPC_STATUS RpcNsMgmtEntryDeleteA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName
);

매개 변수

EntryNameSyntax

EntryName 구문입니다.

레지스트리 값 항목에 지정된 구문을 사용하려면 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax값을 RPC_C_NS_SYNTAX_DEFAULT.

EntryName

삭제할 항목의 이름에 대한 포인터입니다.

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.
RPC_S_INVALID_NAME_SYNTAX	이름 구문이 잘못되었습니다.
RPC_S_UNSUPPORTED_NAME_SYNTAX	이름 구문이 지원되지 않습니다.
RPC_S_INCOMPLETE_NAME	이름이 불완전합니다.
RPC_S_ENTRY_NOT_FOUND	이름 서비스 항목을 찾을 수 없습니다.
RPC_S_NAME_SERVICE_UNAVAILABLE	이름 서비스를 사용할 수 없습니다.
RPC_S_NOT_RPC_ENTRY	RPC 항목이 아닙니다.

 

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

 

설명

관리 애플리케이션은 항목이 더 이상 필요하지 않은 경우에만 RpcNsMgmtEntryDelete 함수를 사용합니다(예: 서버가 서비스에서 영구적으로 제거되는 경우).

이름 서비스 데이터베이스는 비교적 안정적으로 설계되었기 때문에 클라이언트 또는 서버 애플리케이션에서 RpcNsMgmtEntryDelete 를 자주 사용하면 성능 문제가 발생할 수 있습니다. 클라이언트 또는 서버 애플리케이션에서 항목을 만들고 삭제하면 이름 서비스 데이터베이스가 동일한 항목을 반복적으로 제거하고 바꿉니다. 이로 인해 복제된 이름 서비스 데이터베이스의 성능 문제가 발생할 수 있습니다.

참고

rpcnsi.h 헤더는 RpcNsMgmtEntryDelete를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

RpcNsMgmtEntryCreate