IMbnConnectionProfileManager::CreateConnectionProfile 메서드(mbnapi.h)

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

디바이스에 대한 새 연결 프로필을 만듭니다.

구문

HRESULT CreateConnectionProfile(
  [in] LPCWSTR xmlProfile
);

매개 변수

[in] xmlProfile

모바일 광대역 프로필 스키마 참조를 준수하는 XML 형식의 프로필 데이터를 포함하는 null로 끝나는 문자열입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
S_OK	메서드가 완료되었습니다.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	지정된 이름의 프로필이 이미 있습니다.
E_MBN_INVALID_PROFILE	프로필이 모바일 광대역 프로필 스키마를 준수하지 않습니다.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	프로필에 전달된 아이콘 파일 위치가 잘못되었거나 액세스할 수 없습니다.
E_MBN_DEFAULT_PROFILE_EXIST	호출 애플리케이션은 XML 데이터의 기본 프로필 플래그를 지정했습니다. 그러나 모바일 광대역 디바이스에 대한 기본 프로필은 이미 있습니다.

설명

동기 작업입니다. 이 함수 호출이 성공하면 새 프로필이 생성되고 모바일 광대역 서비스에서 IMbnConnectionProfileManagerEvents 인터페이스의 OnConnectionProfileArrival 메서드를 호출합니다.

아이콘 파일 위치가 프로필 데이터에 지정된 경우 모바일 광대역 서비스는 자체 저장소의 지정된 위치에서 아이콘 파일을 복사합니다. 아이콘 파일 위치에 대한 IMbnConnectionProfile 개체에 대한 후속 쿼리는 모바일 광대역 서비스가 아이콘 파일을 저장한 파일 위치를 반환합니다. 시스템에서 프로필을 삭제할 때마다 해당 아이콘 파일도 시스템에서 삭제됩니다. 아이콘 파일은 32x32 픽셀 차원의 bmp 파일 형식 파일이어야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	mbnapi.h

참고 항목

IMbnConnectionProfileManager