Udostępnij za pośrednictwem


sp_OASetProperty (języka Transact-SQL)

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

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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

Argumenty

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

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

  • newvalue
    Nowa wartość właściwośćjest i musi być wartością odpowiedni typ danych.

  • index
    Jest parametrem index.Jeśli określony, index musi być wartością typu odpowiednie dane.

    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.

    Ostrzeżenie

    Parametry dla tej procedura składowana są określane przez położenie nie nazwę.

Wartości kodów powrotnych

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

Aby uzyskać więcej informacji na temat kody powrotne HRESULT zobacz OLE automatyzacji kody zwrotne i informacje o błędzie.

Uprawnienia

Wymaga członkostwa w sysadmin stała rola serwera.

Przykłady

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

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