다음을 통해 공유

RpcNsProfileEltAddA 함수(rpcnsi.h)

  • 아티클

RpcNsProfileEltAdd 함수는 프로필에 요소를 추가합니다. 필요한 경우 항목을 만듭니다.

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

구문

RPC_STATUS RpcNsProfileEltAddA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  unsigned long Priority,
  RPC_CSTR      Annotation
);

매개 변수

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

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

Priority

가져오기 및 조회 작업 중에 새 프로필 요소를 사용하기 위한 상대적 우선 순위를 나타내는 정수 값(0~7)입니다. 값 0이 가장 높은 우선 순위입니다. 값 7이 가장 낮은 우선 순위입니다. 기본 프로필 멤버를 추가할 때 값 0을 사용합니다.

Annotation

새 프로필 요소의 일부로 저장된 주석 문자열에 대한 포인터입니다. 주석 문자열이 없는 경우 null 값 또는 null로 끝나는 문자열을 지정합니다.

문자열은 정보 목적으로만 애플리케이션에서 사용됩니다. 예를 들어 애플리케이션은 이 문자열을 사용하여 IDL 파일에 지정된 인터페이스 이름 문자열을 저장할 수 있습니다. RPC는 조회 또는 가져오기 작업 중 또는 프로필 요소를 열거하는 동안 주석 문자열을 사용하지 않습니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_INVALID_NAME_SYNTAX
 이름 구문이 잘못되었습니다.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 이름 구문이 지원되지 않습니다.
RPC_S_INCOMPLETE_NAME
 이름이 불완전합니다.
RPC_S_NAME_SERVICE_UNAVAILABLE
 이름 서비스를 사용할 수 없습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

RpcNsProfileEltAdd 함수는 ProfileName으로 지정된 이름 서비스 항목의 프로필 특성에 요소를 추가합니다. ProfileName 항목이 없는 경우 RpcNsProfileEltAdd는 프로필 특성을 사용하여 항목을 만들고 IfId, MemberName, Priority 및 Annotation 매개 변수로 지정된 프로필 요소를 추가합니다. 이 경우 애플리케이션에는 항목을 만들 수 있는 권한이 있어야 합니다. 그렇지 않으면 필요한 권한이 있는 관리 애플리케이션은 애플리케이션이 실행되기 전에 RpcNsMgmtEntryCreate 함수를 호출하여 항목을 만들어야 합니다.

지정된 멤버 이름 및 인터페이스 식별이 있는 요소가 이미 프로필에 있는 경우 RpcNsProfileEltAdd 는 Priority 및 Annotation 매개 변수에 제공된 값을 사용하여 요소의 우선 순위 및 주석 문자열을 업데이트합니다.

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

참고

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

요구 사항

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

추가 정보

RpcIfInqId

RpcNsMgmtEntryCreate

RpcNsProfileEltRemove