- 相關(guān)軟件
>sp_OAGetProperty 創(chuàng)建者：webmaster 更新時間：2006-02-16 15:51獲取 OLE 對象的屬性值。
語法
sp_OAGetProperty objecttoken,
propertyname
[, propertyvalue OUTPUT]
[, index...]參數(shù)
objecttoken
是先前用 sp_OACreate 創(chuàng)建的 OLE 對象令牌。
propertyname
是要返回的 OLE 對象的屬性名。
propertyvalue OUTPUT
是返回的屬性值。如果指定，那么它必須是適當數(shù)據(jù)類型的局部變量。
如果屬性返回 OLE 對象，那么 propertyvalue 必須是數(shù)據(jù)類型為 int 的局部變量。對象令牌將保存在該局部變量中，并且可由其它 OLE 自動化存儲過程使用。
如果屬性返回單個值，那么或者為 propertyvalue 指定一個局部變量，以在該局部變量中返回屬性值，或者不指定 propertyvalue，以單列、單行結(jié)果集的形式將屬性值返回給客戶端。
當屬性返回數(shù)組時，如果指定了 propertyvalue，那么該值將被設(shè)置為 NULL。
如果指定了 propertyvalue，但屬性不返回值，那么將出現(xiàn)錯誤。如果屬性返回二維以上的數(shù)組，也將出現(xiàn)錯誤。
索引
是索引參數(shù)。如果指定，那么它必須是適當數(shù)據(jù)類型的值。
一些屬性帶有參數(shù)。這些屬性稱為索引化屬性，其參數(shù)被稱為索引參數(shù)。一個屬性可有多個索引參數(shù)。
說明 此存儲過程的參數(shù)按位置指定，而不是按名稱。
返回代碼值
0（成功）或非零數(shù)字（失?。怯?OLE 自動化對象返回的 HRESULT 的整數(shù)值。
有關(guān) HRESULT 返回代碼的更多信息，請參見 OLE 自動化返回代碼和錯誤信息。
結(jié)果集
如果屬性返回一維或二維數(shù)組，那么該數(shù)組將作為結(jié)果集返回給客戶端：
- 一維數(shù)組作為單行結(jié)果集返回給客戶端，其中的列數(shù)與數(shù)組中的元素數(shù)相等。換言之，該數(shù)組以列的形式返回。
- 二維數(shù)組作為結(jié)果集返回給客戶端，其中的列數(shù)與數(shù)組第一維中的元素數(shù)相同，行數(shù)與數(shù)組第二維中的元素數(shù)相同。換言之，該數(shù)組以（列、行）的形式返回。
當屬性返回值或方法返回值是數(shù)組時，sp_OAGetProperty 或 sp_OAMethod 將向客戶端返回結(jié)果集。（方法輸出參數(shù)不能是數(shù)組。）這些過程掃描數(shù)組中的所有數(shù)據(jù)值，以便為該結(jié)果集的每一列確定正確的 Microsoft® SQL Server™ 數(shù)據(jù)類型和數(shù)據(jù)長度。對于某個特定的列，這些過程將使用表示該列中的所有數(shù)據(jù)值所需要的數(shù)據(jù)類型和長度。
當一列中的所有數(shù)據(jù)值都具有相同的數(shù)據(jù)類型時，此數(shù)據(jù)類型將用于整個列。當一列中的數(shù)據(jù)值使用不同的數(shù)據(jù)類型時，將按下面的圖表選擇整個列的數(shù)據(jù)類型。
int float money datetime varchar nvarchar int int float money varchar varchar nvarchar float float float money varchar varchar nvarchar money money money money varchar varchar nvarchar datetime varchar varchar varchar datetime varchar nvarchar varchar varchar varchar varchar varchar varchar nvarchar nvarchar nvarchar nvarchar nvarchar nvarchar nvarchar nvarchar 注釋
也可用 sp_OAMethod 來獲取屬性值。
權(quán)限
只有 sysadmin 固定服務(wù)器角色的成員才能執(zhí)行 sp_OAGetProperty。
示例
A. 使用局部變量
下面的示例獲取 HostName 屬性（屬于先前創(chuàng)建的 SQLServer 對象）并將其存儲在局部變量中。
DECLARE @property varchar(255)
EXEC @hr = sp_OAGetProperty @object, 'HostName', @property OUT
IF @hr <> 0
BEGIN
EXEC sp_OAGetErrorInfo @object
RETURN
END
PRINT @propertyB. 使用結(jié)果集
下面的示例獲取 HostName 屬性（屬于先前創(chuàng)建的 SQLServer 對象）并將其作為結(jié)果集返回給客戶端。
相關(guān)文章EXEC @hr = sp_OAGetProperty @object, 'HostName'
IF @hr <> 0
BEGIN
EXEC sp_OAGetErrorInfo @object
RETURN
END
本頁查看次數(shù): - 一維數(shù)組作為單行結(jié)果集返回給客戶端，其中的列數(shù)與數(shù)組中的元素數(shù)相等。換言之，該數(shù)組以列的形式返回。