Udostępnij przez


sp_OASetProperty (języka Transact-SQL)

Ustawia nową wartość właściwość obiektu.

Topic link iconKonwencje składni języka Transact-SQL

sp_OASetProperty objecttoken , propertyname , newvalue [ , index... ]

Argumenty

  • objecttoken
    Jest tokenem obiektu z obiekt OLE, który został wcześniej utworzony przez sp_OACreate.

  • propertyname
    Jest nazwą właściwość obiektu OLE, aby ustawić nową wartość.

  • newvalue
    Jest to wartość nowej właściwość, a musi być wartością odpowiedni typ danych.

  • index
    Jest parametrem indeksu.Jeśli określono, index musi być wartością typu danych.

    Niektóre właściwości mają parametrów.Właściwości te są nazywane właściwości indeksowanych i parametry są określane jako parametry indeksu.Właściwość może mieć wiele parametrów indeksu.

    Uwaga

    Parametry dla tej procedura przechowywana są określane przez pozycji nie nazwę.

Wartości kodów powrotnych

0 (sukces) lub liczbę różną od zera (błąd), która jest liczbą całkowitą wartość HRESULT, zwrócone przez obiekt automatyzacji OLE.

Aby uzyskać więcej informacji na temat Kody zwracanych wartości HRESULT zobacz OLE Automation Return Codes and Error Information.

Uprawnienia

Członkostwo w grupie wymaga sysadmin stała rola serwera.

Przykłady

Następujące zestawy przykład HostName Właściwość (z utworzonego wcześniej SQLServer obiektu) na nową wartość.

EXEC @hr = sp_OASetProperty @object, 'HostName', 'Gizmo'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END