MsiViewExecute 함수(msiquery.h)
MsiViewExecute 함수는 SQL 뷰 쿼리를 실행하고 필요한 매개 변수를 제공합니다. 쿼리는 물음표 토큰을 사용하여 SQL 구문에 설명된 대로 매개 변수를 나타냅니다. 이러한 매개 변수의 값은 매개 변수 레코드의 해당 필드로 전달됩니다.
구문
UINT MsiViewExecute(
[in] MSIHANDLE hView,
[in] MSIHANDLE hRecord
);
매개 변수
[in] hView
쿼리를 실행할 뷰에 대한 핸들입니다.
[in] hRecord
매개 변수를 제공하는 레코드에 대한 핸들입니다. 이 매개 변수에는 SQL 쿼리의 매개 변수 토큰을 대체할 값이 포함되어 있습니다. 선택 사항이므로 hRecord는 0일 수 있습니다. 구문에 대한 참조는 SQL 구문을 참조하세요.
반환 값
메모리가 부족한 경우 이 함수는 STATUS_NO_MEMORY 예외를 발생할 수 있습니다.
설명
MsiViewFetch를 호출하기 전에 MsiViewExecute 함수를 호출해야 합니다.
SQL 쿼리가 매개 변수 표식(?)을 사용하여 값을 지정하는 경우 모든 대체 값을 정확한 순서와 호환되는 데이터 형식으로 포함하는 레코드를 제공해야 합니다. INSERT 및 UPDATE 쿼리와 함께 사용할 경우 매개 변수가 있는 모든 값이 매개 변수화되지 않은 모든 값보다 우선해야 합니다.
예를 들어 이러한 쿼리는 유효합니다.
UPDATE {table-list} SET {column}= ? , {column}= {constant}
INSERT INTO {table} ({column-list}) VALUES (?, {constant-list})
그러나 이러한 쿼리는 유효하지 않습니다.
UPDATE {table-list} SET {column}= {constant}, {column}=?
INSERT INTO {table} ({column-list}) VALUES ({constant-list}, ? )
함수가 실패하면 MsiGetLastErrorRecord를 사용하여 확장된 오류 정보를 얻을 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Server 2012, Windows 8, Windows Server 2008 R2 또는 Windows 7의 Windows Installer 5.0. Windows Server 2008 또는 Windows Vista의 Windows Installer 4.0 또는 Windows Installer 4.5. Windows Server 2003 또는 Windows XP의 Windows Installer |
| 대상 플랫폼 | Windows |
| 헤더 | msiquery.h |
| 라이브러리 | Msi.lib |
| DLL | Msi.dll |