ISSCommandWithParameters::GetParameterProperties(OLE DB)

적용 대상: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

OLE DB 드라이버 다운로드

각 UDT 또는 XML 매개 변수당 SSPARAMPROPS 속성 집합을 하나씩 반환하는 방식으로 SSPARAMPROPS 속성 집합 구조의 배열을 반환합니다.

구문

  
HRESULT GetParameterProperties(  
      DB_UPARAMS *pcParams,  
      SSPARAMPROPS **prgParamProperties);  

인수

pcParams[out][in]
prgParamProperties에 반환된 SSPARAMPROPS 구조의 개수를 포함하는 메모리에 대한 포인터입니다.

prgParamProperties[out]
SSPARAMPROPS 구조의 배열이 반환될 메모리에 대한 포인터입니다. 공급자는 구조에 사용할 메모리를 할당하고 이 메모리에 대한 주소를 반환합니다. 소비자는 구조가 더 이상 필요 없게 되면 IMalloc::FreeI를 사용하여 이 메모리를 해제합니다. 변형에 BSTR과 같은 참조 형식이 포함되어 있는 경우 메모리 누수를 방지하려면 소비자는 prgParamProperties에 대해 IMalloc::Free를 호출하기 전에 각 DBPROP 구조의 vValue 속성에 대해 VariantClear를 호출해야 합니다. 출력에서 pcParams가 0이거나 DB_E_ERRORSOCCURRED 외의 오류가 발생하는 경우 공급자는 메모리를 할당하지 않으며 출력에서 prgParamProperties가 Null 포인터인지 확인합니다.

반환 코드 값

GetParameterProperties 메서드는 DB_S_ERRORSOCCURRED 및 DB_E_ERRORSOCCURED를 발생시킬 수 없다는 점을 제외하고 핵심 OLE DB ICommandProperties::GetProperties 메서드와 동일한 오류 코드를 반환합니다.

설명

ISSCommandWithParameters::GetParameterProperties 메서드는 GetParameterInfo에 따라 일정하게 동작합니다. ISSCommandWithParameters::SetParameterProperties 또는 SetParameterInfo가 호출되지 않았거나 cParams가 0인 상태로 호출된 경우 GetParameterInfo가 매개 변수 정보 를 파생시켜 반환합니다. 하나 이상의 매개 변수에 대해 ISSCommandWithParameters::SetParameterProperties 또는 SetParameterInfo가 호출된 경우 ISSCommandWithParameters::GetParameterProperties 메서드는 ISSCommandWithParameters::SetParameterProperties가 호출된 매개 변수에 대해서만 속성을 반환합니다. ISSCommandWithParameters::SetParameterProperties가 ISSCommandWithParameters::GetParameterProperties 또는 GetParameterInfo 이후에 호출된 경우 ISSCommandWithParameters::GetParameterProperties에 대한 후속 호출은 ISSCommandWithParameters::SetParameterProperties 메서드가 호출된 매개 변수에 대해 재정의된 값을 반환합니다.

SSPARAMPROPS 구조는 다음과 같이 정의됩니다.

struct SSPARAMPROPS {

DBORDINAL iOrdinal;

ULONG cPropertySets;

DBPROPSET *rgPropertySets;

};

멤버	Description
iOrdinal	전달된 매개 변수의 서수입니다.
cPropertySets	rgPropertySets에 있는 DBPROPSET 구조의 개수입니다.
rgPropertySets	DBPROPSET 구조의 배열을 반환할 메모리에 대한 포인터입니다.

참고 항목

ISSCommandWithParameters(OLE DB)