RpcNsProfileEltRemoveA 함수(rpcnsi.h)

RpcNsProfileEltRemove 함수는 프로필에서 요소를 제거합니다.

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

 

구문

RPC_STATUS RpcNsProfileEltRemoveA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

매개 변수

ProfileNameSyntax

ProfileName 구문입니다.

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

ProfileName

요소를 제거할 프로필 이름에 대한 포인터입니다.

IfId

제거할 프로필 요소의 인터페이스 식별에 대한 포인터입니다.

null 값을 지정하여 기본 프로필 멤버를 제거합니다.

MemberNameSyntax

MemberName의 구문입니다.

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

MemberName

제거할 프로필 요소의 이름 서비스-항목 이름에 대한 포인터입니다.

반환 값

값	의미
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 반환 값을 참조하세요.

 

설명

RpcNsProfileEltRemove 함수는 ProfileName 항목의 프로필 특성에서 프로필 요소를 제거합니다. 이 함수는 프로필 요소를 제거하려면 MemberName 및 IfId 매개 변수와 정확히 일치해야 합니다. 프로필 요소의 멤버로 포함된 항목(MemberName)은 삭제되지 않습니다.

참고RpcNsProfileEltRemove 를 신중하게 사용: 프로필에서 요소를 제거하면 프로필 계층 구조를 손상시키는 원치 않는 영향을 미칠 수 있습니다.

 

참고 Windows 2000 Active Directory는 이 함수를 지원합니다. 이전 버전의 Windows NT CDS(셀 디렉터리 서비스)에서만 이 함수를 사용할 수 있습니다.

 

참고

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

요구 사항

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

추가 정보

RpcNsProfileDelete

RpcNsProfileEltAdd