LocalDBGetVersionInfo 함수
적용 대상: 
SQL Server
버전이 존재하는지 여부, 전체 LocalDB 버전 번호(빌드 및 릴리스 번호 포함)와 같이 지정한 SQL Server Express LocalDB 버전에 대한 정보를 반환합니다.
정보는 다음 정의가 있는 LocalDBVersionInfo라는 구조체 형식으로 반환됩니다.
typedef struct _LocalDBVersionInfo
{
// Contains the size of the LocalDBVersionInfo struct
DWORD cbLocalDBVersionInfoSize;
// Holds the version name
TLocalDBVersionwszVersion;
// TRUE if the instance files exist on disk, FALSE otherwise
BOOL bExists;
// Holds the LocalDB version for the instance in the format: major.minor.build.revision
DWORD dwMajor;
DWORD dwMinor;
DWORD dwBuild;
DWORD dwRevision;
} LocalDBVersionInfo;
헤더 파일: msoledbsql.h
구문
HRESULT LocalDBGetVersionInfo(
PCWSTR wszVersionName, PLocalDBVersionInfo pVersionInfo, DWORD dwVersionInfoSize);
매개 변수
wszVersionName
[입력] LocalDB 버전 이름입니다.
pVersionInfo
[출력] LocalDB 버전에 대한 정보를 저장할 버퍼입니다.
dwVersionInfoSize
[입력] VersionInfo 버퍼의 크기를 보유합니다.
반품
S_OK
함수가 성공했습니다.
LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB가 컴퓨터에 설치되어 있지 않습니다.
LOCALDB_ERROR_INVALID_PARAMETER
하나 이상의 지정된 입력 매개 변수가 잘못되었습니다.
LOCALDB_ERROR_UNKNOWN_VERSION
지정된 LocalDB 버전이 없습니다.
LOCALDB_ERROR_INTERNAL_ERROR
예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하세요.
세부 정보
구조체 크기 인수(lpVersionInfoSize)가 도입된 이유는 API가 다양한 버전의 LocalDBVersionInfostruct를 반환하여 정방향 및 이전 버전 호환성을 효과적으로 사용하도록 설정하는 것입니다.
구조체 크기 인수(lpVersionInfoSize)가 알려진 LocalDBVersionInfostruct 버전의 크기와 일치하면 해당 버전의 구조체가 반환됩니다. 그렇지 않으면 LOCALDB_ERROR_INVALID_PARAMETER 반환됩니다.
LocalDBGetVersionInfo API 사용의 일반적인 예는 다음과 같습니다.
LocalDBVersionInfo vi;
LocalDBVersionInfo(L"11.0", &vi, sizeof(LocalDBVersionInfo));
설명
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB Reference를 참조하십시오.