지정된 SQL Server Express LocalDB 버전에 대한 정보(예: 존재하는지 여부 및 전체 LocalDB 버전 번호(빌드 및 릴리스 번호 포함)를 반환합니다.
이 정보는 다음 정의가 있는 structLocalDBVersionInfo라는 형식으로 반환됩니다.
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;
헤더 파일: sqlncli.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)가 struct 도입된 이유는 API가 다양한 버전의 LocalDBVersionInfostruct를 반환하여 정방향 및 이전 버전과의 호환성을 효과적으로 가능하게 하는 것입니다.
struct 크기 인수(lpVersionInfoSize)가 알려진 LocalDBVersionInfostruct 버전의 크기와 일치하면 해당 버전 struct 이 반환됩니다. 그렇지 않으면 LOCALDB_ERROR_INVALID_PARAMETER 반환됩니다.
LocalDBGetVersionInfo API 사용의 일반적인 예는 다음과 같습니다.
LocalDBVersionInfo vi;
LocalDBVersionInfo(L"11.0", &vi, sizeof(LocalDBVersionInfo));
비고
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하세요.