sp_OASetProperty (Transact-SQL)

Si applica a:SQL Server

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

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

objecttoken
Token oggetto di un oggetto OLE creato in precedenza da 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, l'indice 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 del codice restituito

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

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

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin o l'autorizzazione di esecuzione direttamente in questa stored procedure. Ole Automation Procedures la configurazione deve essere abilitata per utilizzare qualsiasi procedura di sistema correlata all'automazione OLE.

Esempi

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

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

Vedi anche

Stored procedure di automazione OLE (Transact-SQL)
Script di automazione OLE di esempio