Condividi tramite


sp_OASetProperty (Transact-SQL)

Imposta una proprietà di un oggetto OLE su un nuovo valore.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • objecttoken
    Token di un oggetto OLE creato in precedenza tramite sp_OACreate.

  • propertyname
    Nome della proprietà dell'oggetto OLE da impostare su un nuovo valore.

  • newvalue
    Nuovo valore della proprietà con il tipo di dati appropriato.

  • index
    Parametro di indice. Se specificato, index deve essere un valore del tipo di dati appropriato.

    Ad alcune proprietà sono associati parametri. Tali proprietà sono denominate proprietà indicizzate e i parametri corrispondenti sono denominati parametri di indice. A una proprietà possono essere associati più parametri di indice.

    Nota

    I parametri di questa stored procedure vengono specificati in base alla posizione, non in base al nome.

Valori restituiti

0 (esito positivo) o un numero diverso da zero (esito negativo) corrispondente al valore integer del codice HRESULT restituito dall'oggetto di automazione OLE.

Per ulteriori informazioni sui codici restituiti HRESULT, vedere Codici restituiti e informazioni sugli errori di automazione OLE.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin.

Esempi

Nell'esempio seguente viene impostata su un nuovo valore la proprietà HostName dell'oggetto SQLServer creato in precedenza.

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