OpenNtmsSessionA 함수(ntmsapi.h)

  • 아티클

[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]

OpenNtmsSession 함수는 RSM 서버로 세션을 설정합니다.

구문

HANDLE OpenNtmsSessionA(
  [in] LPCSTR lpServer,
  [in] LPCSTR lpApplication,
       DWORD  dwOptions
);

매개 변수

[in] lpServer

RSM 서버 이름입니다. 이 매개 변수가 NULL이면 현재 컴퓨터 이름이 사용됩니다.

[in] lpApplication

애플리케이션을 식별하는 고유 문자 문자열입니다. 이 이름은 리소스 및 운영자 요청을 식별합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

dwOptions

예약; 0이어야 합니다.

반환 값

OpenNtmsSession이 성공하면 이 세션을 고유하게 식별하는 핸들을 반환합니다. 함수가 실패하면 INVALID_HANDLE_VALUE 반환합니다. 자세한 내용을 검색하려면 GetLastError 함수를 호출합니다. 이 함수는 다음 값 중 하나를 반환할 수 있습니다.

값 의미
ERROR_INVALID_COMPUTERNAME
 지정한 컴퓨터 이름 형식이 유효한 형식이 아닙니다.
ERROR_INVALID_PARAMETER
 매개 변수 값 중 하나가 잘못되었습니다.
ERROR_NO_NETWORK
 네트워크가 시작되지 않았거나 사용할 수 없습니다.
ERROR_NOT_CONNECTED
 RSM 서비스에 연결할 수 없습니다.
ERROR_NOT_READY
 RSM 서비스가 시작되지 않았습니다. 애플리케이션은 기다렸다가 다시 시도해야 합니다.
ERROR_SUCCESS
 함수가 성공했습니다.
INVALID_HANDLE_VALUE
 RSM은 세션을 열 수 없습니다.
RPC_S_NO_INTERFACES
 서비스는 애플리케이션보다 이전 버전의 RSM을 사용하고 있습니다.

설명

OpenNtmsSession 함수는 다른 RSM 함수와 함께 사용되는 세션 핸들을 반환하고, RSM 데이터베이스와의 연결을 설정하고, 애플리케이션에 대한 RSM 하위 시스템을 초기화합니다.

OpenNtmsSession이 반환되면 애플리케이션은 RSM 작업을 수행할 수 있습니다.

세션은 스레드로부터 안전하지만 프로세스 간에 전달할 수 없습니다.

참고

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 ntmsapi.h
라이브러리 Ntmsapi.lib
DLL Ntmsapi.dll

추가 정보

CloseNtmsSession

세션 관리 함수