Delen via

sp_OASetProperty (Transact-SQL)

van toepassing op:SQL Server-

Hiermee stelt u een eigenschap van een OLE-object in op een nieuwe waarde.

Transact-SQL syntaxisconventies

Syntaxis

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

Argumenten

Belangrijk

Argumenten voor uitgebreide opgeslagen procedures moeten worden ingevoerd in de specifieke volgorde, zoals beschreven in de sectie Syntaxis. Als de parameters niet in de volgorde zijn ingevoerd, treedt er een foutbericht op.

objecttoken

Het objecttoken van een OLE-object dat eerder is gemaakt door sp_OACreate.

eigenschapsnaam

De eigenschapsnaam van het OLE-object dat moet worden ingesteld op een nieuwe waarde.

nieuwe waarde

De nieuwe waarde van de eigenschap en moet een waarde van het juiste gegevenstype zijn.

index

Een indexparameter. Indien opgegeven, moet index een waarde van het juiste gegevenstype zijn.

Sommige eigenschappen hebben parameters. Deze eigenschappen worden geïndexeerde eigenschappen genoemd en de parameters worden indexparameters genoemd. Een eigenschap kan meerdere indexparameters hebben.

Notitie

De parameters voor deze opgeslagen procedure worden opgegeven op positie, niet op naam.

Codewaarden retourneren

0 (geslaagd) of een niet-nulnummer (fout) dat de gehele waarde is van het HRESULT dat wordt geretourneerd door het OLE Automation-object.

Zie OLE Automation-retourcodes en foutinformatievoor meer informatie over HRESULT-retourcodes.

Machtigingen

Vereist lidmaatschap van de sysadmin vaste serverfunctie of voer de machtiging rechtstreeks uit voor deze opgeslagen procedure. De Ole Automation-procedures serverconfiguratieoptie moet zijn ingeschakeld voor het gebruik van een systeemprocedure met betrekking tot OLE Automation.

Voorbeelden

In het volgende voorbeeld wordt de eigenschap HostName (van het eerder gemaakte SQLServer-object) ingesteld op een nieuwe waarde.

EXECUTE
    @hr = sp_OASetProperty
    @object,
    'HostName',
    'Gizmo';

IF @hr <> 0
BEGIN
    EXECUTE sp_OAGetErrorInfo @object;
    RETURN;
END

Verwante inhoud